unmark
Type
command
Summary
Sets a card's mark property to false.
Syntax
unmark {<card> | all cards | cards where <condition>}
unmark cards by finding <findString> [in <field>]
Description
Use the unmark command in conjunction with the mark command to narrow down a list of cards for printing or for special treatment by the go and sort commands.
You can unmark cards either one at a time, by specifying each card to be unmarked, or in batches, by using the where condition or by finding forms of the unmark command. Unmarking additional cards does not change the mark property of cards that have already been marked or unmarked.
You can use the mark and unmark commands in succession to further narrow down the set of cards. For example, this sequence of commands selects only the cards where the user has asked for help and the request has not yet been fulfilled:
mark cards by finding \"Help\" in field \"History\"
unmark cards where the hilite of button \"Already Helped\" is true
When using the by finding form, the search operates the same way the normal form of the find command does. The unmark command searches for cards that contain each word in the findString. The words in the findString must be found at the beginning of a word on the card, but the words do not need to be found together.
Parameters
| Name | Type | Description |
|---|---|---|
card | Any card reference. | |
condition | bool | An expression that evaluates to true or false for each card in the current stack. Any object references within the condition are treated as pertaining to each card being evaluated. For example, a reference to a field is evaluated according to that field's contents on each card. |
findString | string | |
field | Any field reference. |
Examples
unmark this card
unmark cards where the label of button "Category Popup" is "None"
unmark cards by finding it
Related
property: mark
keyword: marked, word, words, card
object: card
Compatibility and Support
Introduced
LiveCode 1.0
OS
mac
windows
linux
ios
android
Platforms
desktop
server
mobile